home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / update.man < prev    next >
Encoding:
Text File  |  1992-03-09  |  9.7 KB  |  267 lines
  1.  
  2.  
  3.  
  4. UPDATE                    User Commands                    UPDATE
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      update - A copy program that recursively  updates  directory
  12.      trees
  13.  
  14. SSYYNNOOPPSSIISS
  15.      uuppddaattee [_o_p_t_i_o_n_s] _s_r_c_1 ... _s_r_c_N _t_a_r_g_e_t_D_i_r
  16.      uuppddaattee [_o_p_t_i_o_n_s] _s_r_c _t_a_r_g_e_t
  17.  
  18. OOPPTTIIOONNSS
  19.      --bb _d_i_r_e_c_t_o_r_y   Before updating a target, save a backup  copy
  20.                     of the file in _d_i_r_e_c_t_o_r_y.
  21.  
  22.      --BB _d_a_y_s        Only save the target as a backup copy  if  no
  23.                     backup  exists  or if the target is _d_a_y_s days
  24.                     old.
  25.  
  26.      --ff             Force:  always update targets  regardless  of
  27.                     last-modified times.
  28.  
  29.      --gg _g_r_o_u_p       Change the group  of  any  updated  files  to
  30.                     _g_r_o_u_p.   Targets  that  aren't updated do not
  31.                     have their groups changed.
  32.  
  33.      --hheellpp          Print a summary of the  command-line  options
  34.                     and exit without updating any targets.
  35.  
  36.      --ll             If a source file  is  a  symbolic  link  then
  37.                     uuppddaattee normally creates an identical symbolic
  38.                     link at the destination.  If the --ll switch is
  39.                     specified, then uuppddaattee copies the file refer-
  40.                     enced by the source  link,  rather  than  the
  41.                     link itself.
  42.  
  43.      --mm _m_o_d_e        When updating a target,  set  its  protection
  44.                     bits to _m_o_d_e.  Targets that aren't updated do
  45.                     not have their protection changed.  _M_o_d_e must
  46.                     be specified in octal.
  47.  
  48.      --nn             Be nice about problems with  file  types  not
  49.                     matching (i.e. don't return an error).
  50.  
  51.      --MM             When updating a target, do it by  moving  the
  52.                     source  instead  of  by copying.  This may be
  53.                     useful when disk space is tight.
  54.  
  55.      --oo _o_w_n_e_r       Perform all updates as user  _o_w_n_e_r,  so  that
  56.                     newly-created targets will be owned by _o_w_n_e_r.
  57.                     Any targets that are  not  updated  will  not
  58.                     have their _o_w_n_e_r changed.
  59.  
  60.  
  61.  
  62.  
  63. Sprite v.1.0         Printed:  March 9, 1992                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. UPDATE                    User Commands                    UPDATE
  71.  
  72.  
  73.  
  74.      --OO             This  option  preserves  ownership  on  newly
  75.                     created  files.   Only  root  or  wheel group
  76.                     members can use this option.                   |
  77.  
  78.      --pp _p_r_u_n_e_E_x_p_r                                                       ||
  79.                     Prune  subtress  whose name matches the given  |
  80.                     regular expression.
  81.  
  82.      --qq             Quiet.  Don't print anything except for error
  83.                     messages.   UUppddaattee  normally prints a message
  84.                     for each file copied.
  85.  
  86.      --ss             Strip.  Source files are all expected  to  be
  87.                     executable binaries.  When copying, strip all
  88.                     of the symbol and relocation information from
  89.                     the updated target.
  90.  
  91.      --tt             Instead  of  setting  the  last-accessed  and
  92.                     last-modified  times  of each target to match
  93.                     those of its source,  leave  them  alone,  so
  94.                     that they are set to the current time.
  95.  
  96.      --vv             Verify.  Don't actually modify any files, but
  97.                     print  information  about  which  files would
  98.                     have been modified.
  99.  
  100.      --ii             Ignore symbolic links entirely.
  101.  
  102. _________________________________________________________________
  103.  
  104.  
  105. IINNTTRROODDUUCCTTIIOONN
  106.      The uuppddaattee command is used to replace out-of-date copies  of
  107.      files with more recent versions.  It operates on one or more
  108.      source files.  For each source, uuppddaattee locates a correspond-
  109.      ing  target;   if  the target doesn't exist, or if the last-
  110.      modified time of the source is later than the  last-modified
  111.      time  of  the target, or if the --ff option is specified, then
  112.      uuppddaattee makes a copy  of  the  source  at  the  target.   The
  113.      target's  last-modified  time  and  permissions  will be set
  114.      identical to those of the source.
  115.  
  116.      In the simplest case, two file  names  are  given,  both  of
  117.      which  are  regular files.  In this case the first file name
  118.      is the source and the second is the  target.   If  the  last
  119.      file  name  refers  to  a directory, then all the other file
  120.      names (of which there may be more  than  one)  are  sources.
  121.      Each  source  file will be updated to the corresponding file
  122.      _w_i_t_h_i_n the target directory.  For example, in the command
  123.  
  124.           uuppddaattee //aa//bb cc dd ffoooo
  125.      the target for //aa//bb will be ffoooo//bb, the target for cc will  be
  126.      //ffoooo//cc, and the target for dd will be ffoooo//dd.
  127.  
  128.  
  129.  
  130.  
  131. Sprite v.1.0         Printed:  March 9, 1992                    2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. UPDATE                    User Commands                    UPDATE
  139.  
  140.  
  141.  
  142.      If any of the source files is a directory, then  its  entire
  143.      subtree  will  be updated to the corresponding target, main-
  144.      taining the subtree structure of the source.  In the special
  145.      case where only two file names are given and both are direc-
  146.      tories, then the source is updated _t_o the  target  directory
  147.      rather than _w_i_t_h_i_n it.  Thus, in the command
  148.  
  149.           uuppddaattee aa bb
  150.      where aa and bb are both directories and aa contains  one  sub-
  151.      directory  cc  which  in turn contains one file dd, the target
  152.      corresponding to aa//cc//dd will be bb//cc//dd.   UUppddaattee  will  create
  153.      the directory bb//cc if it doesn't already exist.
  154.  
  155.      UUppddaattee will also copy symbolic links.  Normally  it  creates
  156.      matching symbolic links at the targets, but it will copy the
  157.      files pointed to by the links if the --ll switch is given.
  158.  
  159.      If the target for a source already exists  but  has  a  type
  160.      different  from  the  source (e.g. the target is a directory
  161.      and the source is a regular  file),  then  uuppddaattee  will  not
  162.      modify  the  target.   If the target's last-modified time is
  163.      more recent than the source's, then again  uuppddaattee  will  not
  164.      modify the target.
  165.  
  166.  
  167. UUSSEERR AANNDD GGRROOUUPP CCHHAANNGGEESS
  168.      There are several restrictions on usage of the --OO, --oo and --gg
  169.      switches.  You may specify --OO only if you are root or in the
  170.      wheel group.  You may specify --gg _g_r_o_u_p as long as you are  a
  171.      member of _g_r_o_u_p.  You may specify --oo _o_w_n_e_r if either
  172.  
  173.      [1]  You are _o_w_n_e_r (which isn't very interesting).
  174.  
  175.      [2]  _O_w_n_e_r is rroooott, and you are a member of the wwhheeeell group.
  176.  
  177.      [3]  There is a group with the same name as  _o_w_n_e_r  and  you
  178.           are a member of that group.
  179.  
  180.  
  181. SSEETT--UUSSEERR__IIDD
  182.      If you haven't specified the --mm switch, then uuppddaattee attempts
  183.      to  preserve set-user-id bits.  It also attempts to preserve
  184.      set-user-id bits when making backup copies, even if  the  --mm
  185.      switch   was  given.   However,  set-user-id  bits  are  not
  186.      preserved unless the owner of the target file is the same as
  187.      the  owner of the source file (this condition is always true
  188.      if the --OO switch is given).
  189.  
  190.  
  191. BBAACCKKUUPP FFIILLEESS
  192.      If the --bb switch  is  specified,  then  uuppddaattee  attempts  to
  193.      ensure  that  a  backup  copy of the target is saved, if the
  194.  
  195.  
  196.  
  197. Sprite v.1.0         Printed:  March 9, 1992                    3
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. UPDATE                    User Commands                    UPDATE
  205.  
  206.  
  207.  
  208.      target already exists.  If a backup already exists, then the
  209.      backup  is  overwritten only if the target is relatively old
  210.      (a parameter that defaults to files two weeks old and may be
  211.      overridden by the --BB switch, specifying the requisite age in
  212.      days).  If the --BB switch specifies an age  of  0,  then  the
  213.      most  recent target will always be backed up.  Normally, the
  214.      default of 14 (two weeks)  is  used  to  guarantee  that  an
  215.      unstable file does not overwrite a stable backup.
  216.  
  217.  
  218. PPRRUUNNIINNGG SSUUBB--TTRREEEESS                                                  |
  219.      The --pp option can be used to prune unwanted  sub-trees  from  |
  220.      the  source files. The argument is a regular expression that  |
  221.      is matched against all source files  before  updating  them.  |
  222.      If  the  expression  matches then the source is not updated.  |
  223.      The expression is matched  against  only  the  tail  of  the  |
  224.      source  path  name, so using an expression of "foo/bar" will  |
  225.      not do what you think it will. If the argument contains  any  |
  226.      magic  characters  such as "*" then you better put it inside  |
  227.      of quotes otherwise csh will glob  it  first.   Multiple  --pp  |
  228.      options  can  be  specified and will be compared against the  |
  229.      source files one at a time.
  230.  
  231. KKEEYYWWOORRDDSS
  232.      copy, up-to-date
  233.  
  234.  
  235. SSEEEE AALLSSOO
  236.      cp, mv, tar
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263. Sprite v.1.0         Printed:  March 9, 1992                    4
  264.  
  265.  
  266.  
  267.